Appendix 1 - Methods of class HiGraph 



getRoot 

public HiNode getRootQ 

returns a HiNode object which forms the root of the node tree 
guaranteed to exist and cannot be deleted or moved 



getConnectionMap 

public headway.util.ICollection getConnectionMap() 

returns a (readonly) map containing all essential connections present in the graph 



addConnection 

public boolean addConnection(HiNode fromNode, 
HiNode toNode) 

Deprecated, create a new connection in the graph from the fromNode to the toNode 



addConnection 

public boolean addConnection(HiConnection he) 

create a new connection in the graph from the fromNode to the toNode 



removeConnection 

public void removeConnection(HiConnection he, 
boolean flush) 

remove the passed HiConnection from the graph. Equivalent to calling removeQ on the 
HiConnection 



getNodeMap 

public headway.util.ICollection getNodeMapQ 

returns a (readonly) collection containing all the nodes present in the graph irrespective of 
the nodetree structure 

Note that this does not include the root node 
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findNode 

public HiNode findNode(long id) 

utility method to locate a specific node by key (equivalent to calling getElementQ on the 
graph's NodeMap) 

Returns the corresponding HiNode object or null if none exists 



findNodeByName 

public HiNode findNodeByNanie(java.lang.String name) 

utility method which returns the first node found which matches the name passed or null 
if none found. 

Since node names are not guaranteed to be imique, this method should be used with 
extreme care. It is also highly inefficient in that it needs to iterate all nodes in the graph 
doing a string compare on each. 



findFreeNodeName 

public java.lang.String findFreeNodeName(java.lang. String prefix) 

method which finds the first unused node name with the given prefix e.g. passing 

"cluster" might return cluster 1, cluster 2, etc. 



removeNode 

public void removeNode(HiNode hn, 
boolean flush) 



clear 

public void clear() 

clears the graph i.e. removes all nodes and connections 



flush 

public void flush() 

clears the graph i.e. removes all nodes and connections 
Specified by: 

flush in interface headway .util.Flushable 
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getDirty 

public boolean getDirtyO 



setDirty 

public void setDirty(boolean dirty) 



setDriver 

public void setDriver(HGDriver driver) 



getDriver 

public HGDriver getDriver() 
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Appendix 2 - Fields and Methods of class HiNode 



Fields: 



pathSeparator 

public static java.lang. String pathSeparator 

separation character used for path and fully qualified name 



ID_NEW 

public static final long ID_NEW 



ID_ROOT 

public static final long ID_ROOT 



STATE__UNRESOLVED 

public static final int STATE_UNRESOLVED 

State indicating that node has not yet been resolved (parsed) 



STATE_RESOLVED 

public static final int STATE_RESOLVED 

State indicating that node has been successfully resolved (parsed) 



STATE_UNRESOLVABLE 

public static final int STATE_UNRESOLVABLE 

State indicating that node could not be resolved 

Information on the nature of the reolve failure can be obtained by calling 
getResolveFailureld 



STATE_MISSING 

public static final int STATE_MISSING 
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Indicates that node is missing (and therefore unresolvable) 



STATE_WRONG_LOCATION 

public static final int STATE_WRONG_LOCATION 

Indicates that node has no valid driver and is therefore not resolvable 



STATE_NO_DRIVER 

public static final int STATE_NO_DRIVER 

Indicates that node has no valid driver and is therefore not resolvable 



ATTRIB_PUBLIC 

public static final int ATTRIB_PUBLIC 



ATTRIB_PRIVATE 

public static fmal int ATTRIB_PRIVATE 



ATTRIB_PROTECTED 

public static final int ATTRIB_PROTECTED 



ATTRIB_STATIC 

public static final int ATTRIB_STATIC 



ATTRIB_FINAL 

public static final int ATTRIB_FINAL 



ATTRIB_SYNCHRONIZED 

public static final int ATTRIB_SYNCHRONIZED 



Appendix 2-2 ny2 - U53i65.i 



ATTRIB_THREADSAFE 

public static final int ATTRIB_THREADSAFE 



ATTRIB_TRANSIENT 

public static final int ATTRIB_TRANSIENT 



ATTRIB_NATIVE 

public static final int ATTRIB_NATIVE 



ATTRIB_INTERFACE 

public static final int ATTRIB_INTERFACE 



ATTRIB_ABSTRACT 

public static final int ATTRIB_ABSTRACT 



comparator 

public HiNodeComparator comparator 

Methods: 

resolve 

public int resolve() 

Triggers a parse of the underlying object and loading of connections 



canHaveChildren 

public boolean canHaveChildrenQ 

Returns true if this HiNode can contain children 
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isMeta 



public boolean isMeta() 

Returns true if this node is a metanode, i.e. cannot hold direct connections 



isClass 

public boolean isClassQ 



setid 

protected void setId(long id) 
sets the id of this node 



setGraph 

protected void setGraph(HiGraph hg) 
sets the graph in which this node lives 



setType 

public void setType(int type) 

sets the type of the node - the value corresponds to a constant defined in NodeFactory 



setUML 

public void setUML(java.lang.String uml) 
sets a UML respresentation of this node 



getUML 

public java.lang.String getUMLQ 

returns a UML-style respresentation of this node 



setAttributes 

public void setAttributes(int attributes) 
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takes a bitmask value containing information on various attributes of the node, details see 
ACC constants 



setParent 

protected void setParent(HiNode hn) 
sets the parent of this node 



getType 

public int getTypeQ 

returns the type of the node - the value corresponds to a constant defined in NodeFactory 
use getTypeStringO for a string version 



getTypeString 

public java.lang.String getTypeStringO 

returns a string indicating the type of the node - the value corresponds to a constant 
defined in NodeFactory 



getParent 

public HiNode getParent() 

returns the parent of the node (null if this is the root node) 



setName 

public void setNanieQava.lang.String sName) 
sets the name of this node 



getName 

pubUcjava.lang. String getNameQ 
returns the name of this node 
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setSourceFile 

public void setSourceFile(java.lang.String sourceFile) 
sets the source file name of this node 



getSourceFile 

public java.lang.String getSourceFileQ 
returns the source file name of this node 



setState 

public void setState(int state) 
sets the state of this node 



getState 

public int getStateQ 
returns the state of this node 



getAttributes 

public int getAttributes() 

returns a bitmask containing information on various attributes of the node, details see 
ACC constants 



getAttribute 

public boolean getAttribute(int bit) 

returns a boolean indicating whether the passed attribute flag (or flags) are set in the 
attributes mask 



getid 

public long getld() 

returns the unique id of this node 
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getKey 

public java.lang.Object getKey() 

returns a string key unique to this node (stringified id) 

Specified by: 

getKey in interface headway.util.CoUectionMember 



isRoot 

public boolean isRootQ 

returns true if this is the root node (i.e. parent is null) 



getPath 

public java.lang.String getPathQ 

returns the path of this node (e.g. java.lang) 



getFQName 

public java.lang.String getFQNanie() 

returns the fully qualified name of this node (e.g. if the name is String and the path is 
/java/lang then the fully qualified name is /java/lang/String) 



getGraph 

public HiGraph getGraph() 

returns the graph in which this node resides 



getUserObject 

public java.lang.Object getUserObjectQ 

returns a user-defined object saved with the setUserObject() method 



setUserObject 

public void setUserObject(java.lang.Object obj) 
used to store a reference to an arbitrary object 
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equals 

public boolean equals(HiNode hn) 

true if the passed node is the same as this 



isSibling 

public boolean isSibling(HiNode hn) 

returns true if the passed HiNode is a sibling of this node, i.e. shares the same parent 



toString 

public java.lang.String toString() 

returns the fully qualified name of the node 

Overrides: 

toString in class javalang.Object 



addChild 

public HiNode addChild(HiNode hn) 

creates and returns a new child node of the requested type 

Parameters: 

int - type as defined in NodeFactory 

long - known id of an existing object or ID_NEW (-1) for a new object 



getChildren 

public headway .utilJColIection getChildren() 

returns a JCoUection of the children of this node 

throws an lUegalSomething exception if this node is a leaf 



getChildren 

public headway .util.ICoUection getChildren(HiNodeComparator comparator) 

returns a JCoUection of the children of this node 

throws an lUegalSomething exception if this node is a leaf 



Appendix 2-8 



NY2- 1153165.1 



moveTo 

public void moveTo(HiNode hn, 
boolean flush) 



getConnections 

public headway.util.ICoUection getConnections(int direction) 
returns a collection of connections for this node 
Parameters: 

int - the requested direction HiEdge.TO or HiEdge.FROM 

int - mode MODE„CONNECTION_DIRECT or MODE_CONNECTION_ANY 



getRelationship 

public Relationship getRelationship(HiNode hn, 
int direction) 

returns a Relationship object describing the relationship between this node and the passed 
node for the given direction, a null relationship is signified by the isEmpty flag in the 
relationship object. A null pointer is returned if the passed node is itself null or if it is 
equal to "this" node 



getChildRelationships 

public headway .utiLICoUection getChildRelationshipsQ 

convenience wrapper function which returns all the relationships between the child nodes 
of this node (which must be capable of having children) 



getConnectionCount 

public int getConnectionCount(int direction) 

returns the total number of (potentially rolled up) connections which apply to this node in 
the given direction 



countConnections 
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protected int countConnections(int runningTotal, 
int direction, 
HiNode ancestor) 

counts all connections with recursive calls if an ancestor node is supplied, connections 
where the referenced node is a descendant of the ancestor are ignored 



flush 

public void flush() 

clears the graph i.e. removes all nodes and connections 
Specified by: 

flush in interface headway.util.Flushable 



findCommonAncestor 

public HiNode findConimonAncestor(HiNode hn) 

Utility treewalking method which takes a HiNode argument and returns the (nearest) 
conomon ancestor, guaranteed to return a node (possibly root) provided that neither of this 
node nor the argument node passed is itself the root, in which case an 
IllegalArgumentException is thrown 

Examples: this = root java.util.Vector 
hn = root.java.lang.String 
ret =root.java 
this = root.a.b.c.d 
hn = root.a.b.e.f g.h.i 
ret =root.a,b 



fmdFirstDescendant 

public HiNode findFirstDescendant(HiNode hn) 

Utility treewalking method which takes a HiNode argument which is assumed to be a 
descendant of this node and find the first descendant of this node which is also an 
ancestor of the passed node 

returns null if the node passed is not a descendant of this node 

Examples: this = root java 

hn = root.javaiang.String 
ret = root javaJang 
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this = root.a.b 

hn = root.a.b.e.f.g.hi 

ret =root.a.b.e 



isDescendantOf 

public boolean isDescendantOf(HiNode hn) 



setFQEntityName 

public void setFQEntityName(java.lang.String fqentityname) 



getFQEntityName 

pubhc javaiang.String getFQEntityName() 



getEntityNatne 

public Java Jang. String getEntityNameQ 



getEntityPath 

public javaiang.String getEntityPathQ 
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Appendix 3 - Methods of the MetaNode class 
resolve 

public int resolve() 

Description copied from class: HiNode 

Triggers a parse of the underlying object and loading of connections 
Overrides: 

resolve in class HiNode 



resolve 

public int resolve(boolean recursive) 



canHaveChildren 

public boolean canHaveChildrenQ 

Description copied from class: HiNode 

Returns true if this is can contain children 

Overrides: 

canHaveChildren in class HiNode 



isMeta 

public boolean isMetaQ 

Description copied from class: HiNode 

Returns true if this node is a metanode, i.e. carmot hold direct connections 
Overrides: 

isMeta in class HiNode 



getState 

public int getState() 

Description copied from class: HiNode 

returns the state of this node 

Overrides: 

getState in class HiNode 
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Appendix 4- Methods of the ClassNode class 

canHaveChildren 

public boolean canHaveChildrenQ 

Description copied from class: HiNode 

Returns true if this is can contain children 

Overrides: 

canHaveChildren in class HiNode 



isMeta 

public boolean isMetaQ 

Description copied from class: HiNode 

Returns true if this node is a metanode, i,e. cannot hold direct connections 
Overrides: 

isMeta in class HiNode 



isClass 

public boolean isClassQ 
Overrides: 

isClass in class HiNode 



isApplicationClass 

public boolean isApplicationCIassO 



getFQSourceFile 

public javaJang. String getFQSourceFileQ 



resolve 

public final int resolve() 

Description copied from class: HiNode 

Triggers a parse of the underlying object and loading of connections 
Overrides: 

resolve in class HiNode 
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Appendix 5 - Methods of the FieldNode Class 



canHaveChildren 

public boolean canHaveChildrenQ 

Description copied from class: HiNode 

Returns true if this is can contain children 

Overrides: 

canHaveChildren in class HiNode 



isMeta 

public boolean isMeta() 

Description copied from class: HiNode 

Returns true if this node is a metanode, i.e. cannot hold direct connections 
Overrides: 

isMeta in class HiNode 



getState 

public int getStateQ 

Description copied from class: HiNode 

returns the state of this node 

Overrides: 

getState in class HiNode 
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Appendix 6 - Methods of the MethodNode Class 

canHaveChildren 

public boolean canHaveChildrenQ 

Description copied from class: HiNode 

Returns true if this is can contain children 

Overrides: 

canHaveChildren in class HiNode 



isMeta 

public boolean isMetaQ 

Description copied from class: HiNode 

Returns true if this node is a metanode, i.e. cannot hold direct connections 
Overrides: 

isMeta in class HiNode 



getState 

public int getState() 

Description copied from class: HiNode 

returns the state of this node 

Overrides: 

getState in class HiNode 
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Appendix 7 - Data Fields, Constructors, and Methods of HiEdge class 
Fields: 



DEPENDENCY 

public static final int DEPENDENCY 



AGGREGATION 

public static final int AGGREGATION 



IMPLEMENTS 

public static final int IMPLEMENTS 



EXTENDS 

public static final int EXTENDS 



FROM 

public static final int FROM 



TO 

public static final int TO 
Constructors: 

HiEdge 

public HiEdge(HiNode fromNode, 
HiNode toNode) 



HiEdge 

public HiEdge(HiNode hnl, 
HiNode hn2, 
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int direction) 
Methods: 

makeKey 

public static java.langXong makeKey(HiNode fromNode, 
HiNode toNode) 



makeKey 

public static javaJangXong makeKey(HiNode hnl, 
HiNode hn2, 
int direction) 



getNode 

public HiNode getNode(int direction) 

returns the referenced node for the given direction 



getToggledNode 

public HiNode getToggledNode(int direction) 
returns the referenced node for the given direction 



getKey 

public java.lang.Object getKeyO 
returns a unique key for this object 

implementation is a Long DWord-style long containing the fromNode id in the low word 
and the toNode id in the high word 

Specified by: 

getKey in interface headway .utiLCoUectionMember 



getGraph 

public HiGraph getGraph() 

returns the graph in which the edge resides 
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toString 

public java.Iang.String toStringO 
Overrides: 

toString in class java.Iang.Object 



getType 

public int getTypeQ 



setType 

public void setType(int type) 



isDependency 

public boolean isDependencyQ 



isAggregation 

public boolean isAggregationQ 



islmplements 

public boolean isImplementsQ 



isExtends 

public boolean isExtendsQ 



getVerboseName 

public java.Iang.String getVerboseName() 

returns a longv^inded string version of the edge in the form A->B, used mainly for debug 
purposes 
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toggleDirection 

public static int toggleDirection(int direction) 



getNodeld 

public long getNodeId(int direction) 
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Appendix 8 - Methods of Relationship Class 

Methods: 

isMeta 

public boolean isMetaQ 



getCarriedConnections 

public int getCarriedConnections() 



isEmpty 

pubUc boolean isEmptyQ 



